home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / util2 / icnfgdgt.rea < prev    next >
Text File  |  1996-02-22  |  7KB  |  168 lines
  1. Short:    Adds iconify gadget to windows. BETA version.
  2. Author:   Håkon Enger (henger@fys.uio.no)
  3. Uploader: henger@fys.uio.no
  4. Version:  0.6 beta
  5. Type:     util/misc
  6.  
  7. NOTE: This is a beta version. If you use this program, it WILL cause
  8. your computer to crash, sooner or later. If you still want to try it,
  9. I would be grateful if you tell me when you find a bug.
  10.  
  11. Commodities/IconifyGadget                          Commodities/IconifyGadget
  12.  
  13.  
  14.     NAME
  15.         IconifyGadget - add iconify gadget to windows
  16.  
  17.  
  18.     USAGE
  19.         IconifyGadget [Screens {WORKBENCH|PUBLIC|ALL}] [IKey <keyseq>]
  20.                       [WBWindows {NO|ICONIFY|CLOSE}] [3DLook]
  21.                       [CX_Priority <pri>]
  22.  
  23.  
  24.     REQUIREMENTS
  25.  
  26.         Any Amiga computer with Workbench 2.0 or higher.
  27.  
  28.  
  29.     FUNCTION
  30.  
  31.         If you run a lot of programs that open windows on the Workbench
  32.         screen, the screen easily gets overcrowded. IconifyGadget helps
  33.         with this problem by adding an option to iconify windows. Windows
  34.         that are iconified are temporarily removed from view and replaced
  35.         by an icon. When the icon is double-clicked on, the window appears
  36.         again and the icon disappears. Iconifying windows with Iconify-
  37.         Gadget is done by clicking on a new gadget appearing to the left
  38.         of the "Zoom" gadget in the upper right corner of the window, or
  39.         by pressing a user-selectable key defined by the IKEY parameter.
  40.         Not all windows are iconifiable, see the DISCUSSION section below
  41.         for details. Also read the WARNING and BUGS sections below.
  42.  
  43.         IconifyGadget is a commodity, so it can be controlled by the
  44.         Commodities Exchange utility. Removing IconifyGadget is
  45.         dangerous if other programs have patched the library functions
  46.         that are patched by IconifyGadget. Se DISCUSSION.
  47.  
  48.         The gadget used is visually similar to the iconify gadget used by
  49.         MUI, which is also used by KCON. An alternate image is provided
  50.         and may be selected with the 3DLOOK switch. This image may be
  51.         preferred if you use "SysIHack".
  52.  
  53.  
  54.     PARAMETERS
  55.  
  56.         All parameters can be used as tooltypes when started from WB or
  57.         as command line parameters when started from the Shell.
  58.  
  59.  
  60.         SCREENS     Define which screen(s) the programs will affect.
  61.                     Specifying WORKBENCH will only affect windows on the
  62.                     Workbench screen, PUBLIC will affect windows on all
  63.                     public screens, and ALL will affect windows on all
  64.                     screens. Since the icons appear only on the WB screen,
  65.                     iconifying windows on other screens seems a little
  66.                     weird, but if you want it, there it is. Default is
  67.                     WORKBENCH
  68.  
  69.         IKEY        Specify a key sequence that will iconify the active
  70.                     window. Default is none.
  71.  
  72.         WBWINDOWS   What to do with Workbench windows. Since WB windows
  73.                     (disks, drawers etc.) already have icons, there is
  74.                     really no use in creating another. Still, if you
  75.                     want to iconify WB windows just like all other,
  76.                     specify ICONIFY. If you want an iconify gadget for
  77.                     completeness, but not to create another icon, specify
  78.                     CLOSE. This will make the iconify gadget act exactly
  79.                     like the close gadget. Default is NO.
  80.  
  81.         3DLOOK      For those who like to fool around with sysihack, this
  82.                     switch gives an alternate image for the gadget.
  83.  
  84.         CX_PRIORITY Priority for the commodities exchange broker.
  85.  
  86.  
  87.     DISCUSSION
  88.  
  89.         This program is one I have wanted to write ever since I got hold
  90.         of Ewout Walraven's "Iconify". That program made it possible to
  91.         iconify most windows by pressing ctrl and double-clicking in
  92.         them, but I wanted a gadget to click on! So here it is, finally
  93.         in beta version. Comments and bugreports are welcomed!
  94.  
  95.         I owe a lot to Ewout Walraven for this program, even if he
  96.         doesn't know it himself. The method used for iconifying the
  97.         windows was inspired by "Iconify", and also the icon was stolen
  98.         from there.
  99.  
  100.         The program works by adding a gadget to all windows that are
  101.         iconifyable. That means that they are refreshable and not gimme-
  102.         zerozero or borderless. If the window already has a gadget in the
  103.         position where IconifyGadget adds it's gadget, the window is
  104.         considered not iconifyable by IconifyGadget. This is usually
  105.         because the program that uses the window has provided a way
  106.         to iconify thw window. The windows are iconified by resizing and
  107.         moving the layer of the window to the bottom left corner of the
  108.         screen. (Clicking in this corner may give strange results for
  109.         some windows!) The window is never really removed from the screen,
  110.         so the screen can not be closed if there are any iconified windows
  111.         left.
  112.  
  113.         When the windows are iconified, they will be represented by an
  114.         AppIcon on the Workbench screen. Double-clicking on this icon will
  115.         bring back to full sized window to the front of the screen.
  116.  
  117.         IconifyGadget patches the following intuition.library functions:
  118.         OpenWindow, OpenWindowTagList, CloseWindow, AddGadget and
  119.         WindowToFront. If a program that patches any of these is started
  120.         after IconifyGadget, it should be removed before IconifyGadget is
  121.         removed.
  122.  
  123.  
  124.     WARNING
  125.  
  126.         Fooling around with other programs' windows is NOT a nice thing to
  127.         do. If you don't like to take chances, don't use this program.
  128.  
  129.  
  130.     BUGS
  131.  
  132.         This is a beta version, so there are probably lots of unknown bugs.
  133.  
  134.         There is at least one known bug that makes CPR crash if you try
  135.         to add an iconify gadget to it's windows. I have not been able to
  136.         find out why this happens.
  137.  
  138.         Some windows mysteriously un-iconifies themselves if you click in
  139.         the lower right corner of the screen.
  140.  
  141.         When you find a bug, please inform me on how it occured. If you
  142.         have the source code to the program that was making IconifyGadget
  143.         crash, it would be of great help to me if you could send that too.
  144.         My address (email and otherwise) is at the end of this document.
  145.  
  146.  
  147.     COPYRIGHT
  148.  
  149.         IconifyGadget is Copyright © 1995 Håkon Enger
  150.  
  151.         This beta version may not be distributed without explicit
  152.         permission from the author. Such permission is given to the AmiNet
  153.         collection of Amiga software FTP sites.
  154.  
  155.  
  156.     AUTHOR
  157.  
  158.         Håkon Enger
  159.  
  160.         Email addresses: henger@fys.uio.no, haakone@ifi.uio.no. If one of
  161.         them bounces, try the other one.
  162.  
  163.         Regular mail should be addressed to:
  164.             Håkon Enger
  165.             Rikard Nordraaksveg 12
  166.             N-2400 Elverum
  167.             Norway
  168.